home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / COMM / FRX10.ARJ / RXFER.DOC < prev    next >
Text File  |  1992-03-08  |  44KB  |  1,031 lines
  1.  
  2.  
  3.  
  4.                        ┌──────────────────────────────────────┐
  5.                        │                                      │
  6.                        │              Transfer Log Processor  │
  7.                        │  ┬─┬─────┐   For Robocomm 4.x (tm)   │
  8.                        │  │ │     │                           │
  9.                        │  │ ├───┬─┘           FREEWARE!!      │
  10.                        │  │ │   │           For Registered    │
  11.                        │  ┴─┴   ┴──         Robocomm Users    │
  12.                        │           ┐     ┌                    │
  13.                        │            └┐ ┌┘                     │
  14.                        │              ┼    ┬┬──┐ ┬┬──┐ ┬┬──┐  │
  15.                        │            ┌┘ └┐  │├─   │├─   │├─┬┘  │
  16.                        │           ┘     └ ┴┴    ┴┴──┘ ┴┴ ┴─  │
  17.                        │                                      │
  18.                        │            Version 1.00              │
  19.                        └──────────────────────────────────────┘
  20.                        ┌──────────────────────┐
  21.                        │         RXfer        │
  22.                        │  Copyright (c) 1992  │
  23.                        │      Ron Eisner      │
  24.                        └──────────────────────┘
  25.  
  26.  
  27.     Freeware RXfer
  28.      Copyright (c) 1992 Ronald J. Eisner
  29.      ___________________________________________________________________________
  30.  
  31.  
  32.      TABLE OF CONTENTS
  33.      -----------------
  34.  
  35.  
  36.      DISCLAIMER OF WARRANTY  . . . . . . . . . . . . . . iii
  37.  
  38.      LIMITS OF LIABILITY . . . . . . . . . . . . . . . . iii
  39.  
  40.      LICENSE AGREEMENT . . . . . . . . . . . . . . . . .  iv
  41.  
  42.      WHAT IS RXFER?  . . . . . . . . . . . . . . . . . .   v
  43.  
  44.      PROGRAM FEATURES  . . . . . . . . . . . . . . . . .  vi
  45.  
  46.      PROGRAM REQUIREMENTS  . . . . . . . . . . . . . . .  vi
  47.  
  48.      DISTRIBUTION FILE LIST  . . . . . . . . . . . . . . vii
  49.  
  50.      INSTALLATION  . . . . . . . . . . . . . . . . . . .   1
  51.  
  52.      PROGRAM CONFIGURATION . . . . . . . . . . . . . . .   1
  53.  
  54.      AUTOMATIC TRANSFER.LOG PROCESSING . . . . . . . . .   2
  55.  
  56.      LOOKING UP FILE TRANSFERS . . . . . . . . . . . . .   3
  57.  
  58.      LOOKING UP FILE TRANSFERS BY FILENAME . . . . . . .   3
  59.  
  60.      THE FILE ACTIVITY TABLE . . . . . . . . . . . . . .   3
  61.  
  62.      THE LOCATOR . . . . . . . . . . . . . . . . . . . .   4
  63.  
  64.      USING THE LOCATOR . . . . . . . . . . . . . . . . .   4
  65.           FINDING FILES WITH THE LOCATOR . . . . . . . .   5
  66.  
  67.      DELETING CHARACTERS FROM THE LOCATOR  . . . . . . .   5
  68.  
  69.      LOOKING UP FILE TRANSFERS BY BBS  . . . . . . . . .   6
  70.  
  71.      EXPORTING DATA  . . . . . . . . . . . . . . . . . .   6
  72.  
  73.      QUITTING RXFER  . . . . . . . . . . . . . . . . . .   7
  74.  
  75.      TECHNICAL SUPPORT . . . . . . . . . . . . . . . . .   8
  76.  
  77.      NEW VERSION AVAILABILITY  . . . . . . . . . . . . .   9
  78.  
  79.      INDEX . . . . . . . . . . . . . . . . . . . . . . .  11
  80.  
  81.  
  82.     Freeware RXfer                                                          iii
  83.      Copyright (c) 1992 Ronald J. Eisner
  84.      ___________________________________________________________________________
  85.  
  86.  
  87.      DISCLAIMER OF WARRANTY
  88.      ----------------------
  89.  
  90.  
  91.      THIS SOFTWARE AND ANY ACCOMPANYING MATERIALS AND OR FILES (SUCH AS DOCUMEN-
  92.      TATION OR SAMPLE DATA) ARE DISTRIBUTED "AS IS" AND WITHOUT WARRANTIES AS TO
  93.      PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR
  94.      IMPLIED.  BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
  95.      WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR
  96.      PURPOSE IS OFFERED.
  97.  
  98.  
  99.  
  100.      LIMITS OF LIABILITY
  101.      -------------------
  102.  
  103.  
  104.      FREEWARE RXFER, IN ALL OF ITS RELEASES, IS COMPUTER SOFTWARE AND AS SUCH
  105.      MAY CONTAIN BUGS AND/OR FLAWS THAT CAUSE THE PROGRAM TO PERFORM OTHER THAN
  106.      INTENDED.  INDEED, THE PROGRAM MAY CONTAIN FLAWS THAT CAUSE DAMAGE TO YOUR
  107.      SYSTEM AND/OR DATA STORED ON YOUR SYSTEM.  WHILE A GOOD FAITH EFFORT HAS
  108.      BEEN EXPENDED TO ELIMINATE ALL DAMAGING BUGS AND FLAWS, AND NONE ARE KNOWN
  109.      TO EXIST, THERE IS NO GUARANTEE THAT SUCH BUGS AND FLAWS DO NOT EXIST.  THE
  110.      USER MUST THEREFORE ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  NO
  111.      LIABILITY IS ASSUMED BY THE AUTHOR OR ANY AUTHORIZED SELLER AND/OR DISTRIB-
  112.      UTOR OF THIS SOFTWARE.
  113.  
  114.  
  115.     Freeware RXfer                                                           iv
  116.      Copyright (c) 1992 Ronald J. Eisner
  117.      ___________________________________________________________________________
  118.  
  119.  
  120.      LICENSE AGREEMENT
  121.      -----------------
  122.  
  123.  
  124.           1:   Freeware RXfer is distributed as FREEWARE.  FREEWARE is NOT
  125.                PUBLIC DOMAIN!  Freeware is legally copyrighted and protect-
  126.                ed software distributed at no charge to the end user.
  127.  
  128.           2:   You are licensed to use Freeware RXfer on as many systems as
  129.                you desire.  You may simultaneously use multiple copies of
  130.                Freeware RXfer on single or multiple systems.
  131.  
  132.           3:   You MUST be a REGISTERED user of Robocomm.
  133.  
  134.                a:   You CANNOT modify the RXfer executable to
  135.                     bypass the check for a registered copy of
  136.                     Robocomm.
  137.  
  138.           4:   You are allowed to distribute Freeware RXfer as described
  139.                below:
  140.  
  141.                a:   You may only distribute UNMODIFIED COPIES of Freeware
  142.                     RXfer files.
  143.  
  144.                b:   You MUST distribute ALL of the files listed in the
  145.                     DISTRIBUTION FILE LIST, page vii, below, and ONLY those
  146.                     files.  You may, however, add or replace the archive
  147.                     description - but the author's description is pre-
  148.                     ferred.  (Note that you must include FILE_ID.DIZ and
  149.                     DESC.SDI in your distribution as they are listed in the
  150.                     DISTRIBUTION FILE LIST.)
  151.  
  152.                c:   You are allowed to distribute Freeware RXfer freely
  153.                     among BBS systems.
  154.  
  155.                d:   You may add Freeware RXfer to a User Group library as
  156.                     long as no fee is charged for the ability of the
  157.                     Freeware RXfer archive to be "checked out" of said
  158.                     library.
  159.  
  160.                e:   You are NOT allowed to charge any fee for the distribu-
  161.                     tion of Freeware RXfer without the express written
  162.                     consent of the legal copyright holder, Ron Eisner.
  163.  
  164.  
  165.     Freeware RXfer                                                            v
  166.      Copyright (c) 1992 Ronald J. Eisner
  167.      ___________________________________________________________________________
  168.  
  169.  
  170.      WHAT IS RXFER?
  171.      --------------
  172.  
  173.  
  174.        FREEWARE RXFER is a Robocomm (tm) TRANSFER.LOG processor.  It will read
  175.      your TRANSFER.LOG and allow you to look up information about your file
  176.      transfers.  It maintains two databases - "FILE TRANSFER" (filename
  177.      XFERFILE.DAT) and "BBS" (filename XFERBBS.DAT).  The file transfer database
  178.      contains one record for each line in the Robocomm TRANSFER.LOG file.  The
  179.      BBS database contains one record for each unique BBS found in the file
  180.      transfer records.
  181.  
  182.        With these two databases, you can look up any file and see all of the
  183.      BBS's it has been transferred from or to.  Or, you can look up a specific
  184.      BBS and see all of the file transfers that have taken place with that
  185.      system.
  186.  
  187.        RXFER is primarily a tool to help you determine to what systems you
  188.      should upload particular files.  If your memory is as short as the
  189.      author's, you frequently cannot remember to which BBS's a file has been
  190.      uploaded.  Consequently, you may create upload agendas that duplicate past
  191.      efforts.
  192.  
  193.        Robocomm performs a duplicate file check on a system prior to executing
  194.      an upload agenda item.  Thus, it is not likely that your duplicate upload
  195.      agenda item will actually result in uploading a file to a single system
  196.      more than once (unless the BBS converts your archive format to a different
  197.      one - resulting in the failure of Robocomm's duplicate file check).
  198.      However, you will have wasted valuable time constructing the agenda.
  199.  
  200.        In addition, if you have forgotten to which systems you have uploaded
  201.      particular files, you will likely also have forgotten some of the files
  202.      that have NOT been uploaded to certain BBS's.  Thus, you will likely miss
  203.      good upload candidates.
  204.  
  205.        Rather than blindly construct upload agendas that may contain files
  206.      already uploaded to a particular system or may not contain files that COULD
  207.      be uploaded to a system, you can use RXFER to see exactly what BBS's have
  208.      received an upload candidate.  This information allows you to construct
  209.      upload agendas that reflect the best upload candidates that you have
  210.      available.
  211.  
  212.        RXFER employs scrolling lookup tables similar to those by Robocomm in its
  213.      Available Files and Downloaded Files databases.  In addition, RXFER has a
  214.      unique LOCATOR feature that allows you to position the lookup table
  215.      highlight bar on any file or BBS record stored in the database by typing
  216.      the first few characters of its name.
  217.  
  218.  
  219.     Freeware RXfer                                                           vi
  220.      Copyright (c) 1992 Ronald J. Eisner
  221.      ___________________________________________________________________________
  222.  
  223.  
  224.      PROGRAM FEATURES
  225.      ----------------
  226.  
  227.  
  228.           Freeware RXfer has the following features:
  229.  
  230.           * FREE!  (Works with registered copies of Robocomm only.)
  231.           * Easy to use interface.
  232.           * Menu-driven.
  233.           * Automatic processing of Robocomm's TRANSFER.LOG.
  234.           * Context-sensitive on-line help.
  235.           * Lookup transfers by filename or by BBS.
  236.           * No practical limit on number of files in database (over two
  237.             billion).
  238.           * Scrolling lookup tables similar to those used by Robocomm in
  239.             its Files databases.
  240.           * Unique table Locator to quickly and interactively find ANY
  241.             file by typing just a few characters of the name.
  242.           * Data can be exported to ASCII.
  243.           * Uses extra RAM to cache its data files for faster perfor-
  244.             mance.
  245.           * Keeps details of each file transfer - such as date, time and
  246.             duration of transfer; number of errors; transfer protocol;
  247.             CPS; originating/destinating BBS.
  248.  
  249.  
  250.  
  251.      PROGRAM REQUIREMENTS
  252.      --------------------
  253.  
  254.  
  255.           Freeware RXfer has the following requirements:
  256.  
  257.           * 400K bytes disk space (program files) + about 25,000 bytes
  258.             per 100 transfers on file.
  259.           * 410K free RAM (any extra RAM is used to increase
  260.             performance).
  261.           * DOS 3.3 or higher (DR DOS 5.0/6.0 works fine).
  262.           * REGISTERED copy of ROBOCOMM 4.0 or higher.
  263.           * Installation in ROBOCOMM subdirectory.
  264.           * FILES=20 or greater.
  265.  
  266.           * Recommend a disk cache.
  267.           * Recommend an 80286 or better.
  268.           * RXfer works fine under QEMM (tm) & DESQview (tm).
  269.  
  270.  
  271.     Freeware RXfer                                                          vii
  272.      Copyright (c) 1992 Ronald J. Eisner
  273.      ___________________________________________________________________________
  274.  
  275.  
  276.      DISTRIBUTION FILE LIST
  277.      ----------------------
  278.  
  279.  
  280.        Freeware RXfer includes or creates the following files:
  281.  
  282.  
  283.              ┌────────────────────────────────────────────────────────┐
  284.              │          FREEWARE RXFER DISTRIBUTION FILE LIST         │
  285.              ├──────────────┬─────────────────────────────────────────┤
  286.              │ RXFER.EXE    │  Main program executable.               │
  287.              ├──────────────┼─────────────────────────────────────────┤
  288.              │ RXFER.HLP    │  Context Sensitive Help file.           │
  289.              ├──────────────┼─────────────────────────────────────────┤
  290.              │ RXFER.DOC    │  Program Documentation (this file).     │
  291.              ├──────────────┼─────────────────────────────────────────┤
  292.              │ RXFER.NEW    │  New information.                       │
  293.              ├──────────────┼─────────────────────────────────────────┤
  294.              │ RXFER.FRM    │  Order form for Shareware RXfer Plus.   │
  295.              ├──────────────┼─────────────────────────────────────────┤
  296.              │ ANALYZE.FRX  │  Sample ANALYZE.BAT file to allow RXFER │
  297.              │              │  to be called from within Robocomm.     │
  298.              │              │                                         │
  299.              │              │  To use this, simply rename it to       │
  300.              │              │  ANALYZE.BAT - OR - incorporate it      │
  301.              │              │  into an existing ANALYZE.BAT           │
  302.              ├──────────────┼─────────────────────────────────────────┤
  303.              │ FILE_ID.DIZ  │  Description In ZIP file.               │
  304.              ├──────────────┼─────────────────────────────────────────┤
  305.              │ DESC.SDI     │  Another ZIP description file.          │
  306.              └──────────────┴─────────────────────────────────────────┘
  307.              ┌────────────────────────────────────────────────────────┐
  308.              │             FILES CREATED BY FREEWARE RXFER            │
  309.              ├──────────────┬─────────────────────────────────────────┤
  310.              │ RXFER.CFG    │  Configuration file.                    │
  311.              ├──────────────┼─────────────────────────────────────────┤
  312.              │ TRANSFER.001 │  TRANSFER.LOG ASCII "spill" file.       │
  313.              ├──────────────┼─────────────────────────────────────────┤
  314.              │ XFERBBS.DAT  │  BBS database and key files.            │
  315.              │ XFERBBS.K01  │                                         │
  316.              │ XFERBBS.K02  │                                         │
  317.              ├──────────────┼─────────────────────────────────────────┤
  318.              │ XFERFILE.DAT │  Files database and key files.          │
  319.              │ XFERFILE.K01 │                                         │
  320.              │ XFERFILE.K02 │                                         │
  321.              │ XFERFILE.K03 │                                         │
  322.              │ XFERFILE.K04 │                                         │
  323.              └──────────────┴─────────────────────────────────────────┘
  324.  
  325.  
  326.     Freeware RXfer                                                            1
  327.      Copyright (c) 1992 Ronald J. Eisner
  328.      ___________________________________________________________________________
  329.  
  330.  
  331.      INSTALLATION
  332.      ------------
  333.  
  334.  
  335.        Installation of Freeware RXfer is easy.  Simply copy all of the files
  336.      included with Freeware RXfer into your Robocomm subdirectory.  If you
  337.      received Freeware RXfer from a BBS in an archive format, simply un-archive
  338.      it into your Robocomm subdirectory.
  339.  
  340.      NOTE:  Freeware RXfer does not contain any files with names matching names
  341.             of Robocomm files - so there is no need to worry about overwriting
  342.             any Robocomm files.  If you are still concerned, compare the
  343.             Freeware RXfer Distribution File List (above) against the files in
  344.             your Robocomm subdirectory first to be sure.
  345.  
  346.  
  347.  
  348.      PROGRAM CONFIGURATION
  349.      ---------------------
  350.  
  351.  
  352.        There isn't any program configuration possible with Freeware RXfer.
  353.      (Shareware RXfer Plus has tons of configuration options.)
  354.  
  355.        The first time you run Freeware RXfer, a screen will be displayed that
  356.      explains how RXfer works.  RXfer will automatically process any existing
  357.      TRANSFER.LOG file each time it is run - EXCEPT the first time (or any
  358.      subsequent time if it does NOT find the file RXFER.CFG in the same subdi-
  359.      rectory - which indicates to RXFER that it is a first time run - see below.
  360.      If the file RXFER.CFG is erased then this condition will apply).
  361.  
  362.        The first time you run RXfer, the above is explained.  Next you choose to
  363.      allow or not allow RXfer to create RXFER.CFG.
  364.  
  365.        If you choose to NOT allow RXFER.CFG to be created, then the next time
  366.      you run RXFER it will again explain the above and again ask if you want to
  367.      create RXFER.CFG.  In other words, until you allow RXFER.CFG to be created,
  368.      the program will not do anything more than the above.
  369.  
  370.        Once you choose to allow RXFER.CFG to be created, RXFER will create the
  371.      file and then exit back to DOS.  It is now "configured".  Note that during
  372.      the initial run described above, where you choose to allow RXFER.CFG to be
  373.      created, RXFER will NOT process any existing TRANSFER.LOG file.
  374.  
  375.        Once configured, each time RXFER is run, if it finds an existing
  376.      TRANSFER.LOG, RXFER will process it.  Thus, the next time you run RXFER
  377.      after allowing RXFER.CFG to be created, your Robocomm TRANSFER.LOG file (if
  378.      any) will be processed.
  379.  
  380.        The reason RXFER requires you to allow it to create RXFER.CFG prior to it
  381.      doing any processing is that this author does not want any surprises to
  382.      take place.  In other words, until you explicitly allow RXFER to do its
  383.      work - it will not do anything.
  384.  
  385.  
  386.     Freeware RXfer                                                            2
  387.      Copyright (c) 1992 Ronald J. Eisner
  388.      ___________________________________________________________________________
  389.  
  390.  
  391.      AUTOMATIC TRANSFER.LOG PROCESSING
  392.      ---------------------------------
  393.  
  394.  
  395.        Freeware RXfer automatically processes any existing TRANSFER.LOG each
  396.      time it is run.  What occurs during processing is described below.
  397.  
  398.  
  399.           1  For each record found in TRANSFER.LOG:
  400.  
  401.              1.1  The record is written out to the file TRANSFER.001.  This
  402.                   record is identical in format to the one read from
  403.                   TRANSFER.LOG.  (It is simply a copy of the record from
  404.                   TRANSFER.LOG.)
  405.  
  406.                   1.1.1  TRANSFER.001 exists as a "backup" of your Robocomm-
  407.                          created TRANSFER.LOG.  RXFER does not leave processed
  408.                          records in TRANSFER.LOG because to do so would cause
  409.                          RXfer to work through previously processed entries on
  410.                          subsequent runs.
  411.  
  412.                   1.1.2  TRANSFER.001 will keep "growing" in size as new
  413.                          TRANSFER.LOG files get processed.  RXFER does not prune
  414.                          this file for you.  You should occasionally prune
  415.                          TRANSFER.001 by archiving it and allowing a new one to
  416.                          start; or deleting it; or renaming it.  (RXFER PLUS has
  417.                          several automatic pruning options.)
  418.  
  419.                   1.1.3  TRANSFER.001 can be used to rebuild the RXfer database.
  420.                          If you rename TRANSFER.001 to TRANSFER.LOG and then
  421.                          delete the XFERFILE and XFERBBS database files and keys
  422.                          (see DISTRIBUTION FILE LIST, page vii), the next time
  423.                          you run RXfer it will recreate the databases from the
  424.                          TRANSFER.LOG file as if it were a normal TRANSFER.LOG
  425.                          file created by Robocomm.  You likely would have no
  426.                          reason to do this, but if you find the need the capa-
  427.                          bility is there.
  428.  
  429.              1.2  The file contained in the record is added to the files data-
  430.                   base file XFERFILE.DAT.
  431.  
  432.                   1.2.1  RXFER makes an attempt to recognize duplicate records
  433.                          in order to reduce redundant records in the database.
  434.                          If a record has the same filename, date & time of
  435.                          transfer to a BBS of another record in the database, it
  436.                          is considered a duplicate and is skipped.  Duplicates
  437.                          are spilled to TRANSFER.001.  (RXFER PLUS allows dupli-
  438.                          cates to be left out of TRANSFER.001.)
  439.  
  440.                   1.2.2  If the record is in a format not recognized by RXFER,
  441.                          it is ignored.  These records are spilled to
  442.                          TRANSFER.001.  (RXFER PLUS allows these record types to
  443.                          be spilled to a different file.)
  444.  
  445.  
  446.     Freeware RXfer                                                            3
  447.      Copyright (c) 1992 Ronald J. Eisner
  448.      ___________________________________________________________________________
  449.  
  450.  
  451.              1.3  If a new BBS (not found in the database) is indicated in the
  452.                   record being processed, that BBS is added to the BBS database
  453.                   file XFERBBS.DAT.
  454.  
  455.           2  Once all records are processed, TRANSFER.LOG is deleted.
  456.  
  457.  
  458.  
  459.      LOOKING UP FILE TRANSFERS
  460.      -------------------------
  461.  
  462.  
  463.        Making previous file transfer lookups easy is RXfer's raison d'etre.
  464.  
  465.        RXFER allows you to look up by filename or by BBS.
  466.  
  467.  
  468.  
  469.      LOOKING UP FILE TRANSFERS BY FILENAME
  470.      -------------------------------------
  471.  
  472.  
  473.        From the RXFER Main Menu select FILE ACTIVITY to examine the file
  474.      transfer database.  The file activity table will appear.
  475.  
  476.  
  477.  
  478.      THE FILE ACTIVITY TABLE
  479.      -----------------------
  480.  
  481.  
  482.        The file activity table is sorted in alphabetical order.  Any files
  483.      transferred to more than one BBS will show a separate line for each BBS, in
  484.      BBS order.
  485.  
  486.  
  487.     Freeware RXfer                                                            4
  488.      Copyright (c) 1992 Ronald J. Eisner
  489.      ___________________________________________________________________________
  490.  
  491.  
  492.        The following keys control movement and other actions within the file
  493.      activity table:
  494.  
  495.  
  496.          ┌───────────────────┬────────────────────────────────────────────┐
  497.          │                   │ FILE ACTIVITY TABLE KEYS                   │
  498.          │                   │ (Same as BBS table keys)                   │
  499.          │ ^ = <CTRL> key.   │                                            │
  500.          ├───────────────────┼────────────────────────────────────────────┤
  501.          │  <Arrow Keys>     │ Move highlight bar up/down one line.       │
  502.          │                   │ Table will scroll at top/bottom.           │
  503.          ├───────────────────┼────────────────────────────────────────────┤
  504.          │  <ENTER>          │ View Log Detail for highlighted record.    │
  505.          ├───────────────────┼────────────────────────────────────────────┤
  506.          │  <PgUp>           │ Scroll up one page.                        │
  507.          ├───────────────────┼────────────────────────────────────────────┤
  508.          │  <PgDn>           │ Scroll down one page.                      │
  509.          ├───────────────────┼────────────────────────────────────────────┤
  510.          │ ^<PgUp>           │ Move bar to first entry in database.       │
  511.          ├───────────────────┼────────────────────────────────────────────┤
  512.          │ ^<PgDn>           │ Move bar to last entry in database.        │
  513.          ├───────────────────┼────────────────────────────────────────────┤
  514.          │  <HOME>           │ Move bar to top of scroll area.            │
  515.          ├───────────────────┼────────────────────────────────────────────┤
  516.          │  <END>            │ Move bar to bottom of scroll area.         │
  517.          ├───────────────────┼────────────────────────────────────────────┤
  518.          │  <DELETE>         │ Delete highlighted record (you are         │
  519.          │                   │ prompted for confirmation).                │
  520.          ├───────────────────┴────────────────────────────────────────────┤
  521.          │                           LOCATOR KEYS                         │
  522.          ├───────────────────┬────────────────────────────────────────────┤
  523.          │ Alphanumeric      │ Build locator entry, dynamically moving    │
  524.          │ Keys; Punctuation │ highlight bar to find matching entry.      │
  525.          │  <BACKSPACE>      │ Delete one Locator character, move bar in  │
  526.          │                   │ reverse to record matching remaining por-  │
  527.          │                   │ tion of Locator entry.                     │
  528.          ├───────────────────┼────────────────────────────────────────────┤
  529.          │ ^<BACKSPACE>      │ Clear entire Locator, don't move bar.      │
  530.          ├───────────────────┼────────────────────────────────────────────┤
  531.          │  <ESC>            │ Exit table back to Main Menu.              │
  532.          └───────────────────┴────────────────────────────────────────────┘
  533.  
  534.  
  535.      THE LOCATOR
  536.      -----------
  537.  
  538.  
  539.        The RXfer Filename Locator allows you to quickly find any file in the
  540.      database simply by pressing the first few keys of the desired filename.
  541.  
  542.  
  543.  
  544.      USING THE LOCATOR
  545.      -----------------
  546.  
  547.  
  548.     Freeware RXfer                                                            5
  549.      Copyright (c) 1992 Ronald J. Eisner
  550.      ___________________________________________________________________________
  551.  
  552.  
  553.        To use the Locator, you do not have to "select" it.  When in an RXfer
  554.      table, any alphabetic, numeric or punctuation key is considered to be a
  555.      Locator key and, when typed, is automatically displayed as part of the
  556.      Locator.  In other words, all non-movement and non-function keys are
  557.      Locator keys.
  558.  
  559.  
  560.  
  561.      FINDING FILES WITH THE LOCATOR
  562.      ------------------------------
  563.  
  564.  
  565.        To find a filename, simply begin typing its name.
  566.  
  567.        As you type each character into the Locator, the table's highlight bar
  568.      will move itself to the first database entry that matches what you have
  569.      typed in thus far.
  570.  
  571.        For example, if you type as the first character into the Locator the
  572.      letter "R", the table highlight bar will move itself to the first filename
  573.      beginning with the letter "R".  If you next type "O" (resulting in the
  574.      letters "RO" being within the Locator), the highlight bar will move to the
  575.      first filename beginning with the letters "RO".  If you then type "B"
  576.      (resulting in "ROB" in the Locator), the first filename beginning with
  577.      "ROB" will become highlighted.
  578.  
  579.        By the time you have typed in the example above, you are likely to have
  580.      found "ROBOCOMM" in the database - no matter how many filenames are in the
  581.      database!
  582.  
  583.        The general idea is that to find a particular filename, you only need to
  584.      type enough characters to uniquely identify it.
  585.  
  586.        If there is no entry matching what you have typed in, the highlight bar
  587.      will move to the closest filename FOLLOWING the place where the match would
  588.      be located.
  589.  
  590.  
  591.  
  592.      DELETING CHARACTERS FROM THE LOCATOR
  593.      ------------------------------------
  594.  
  595.  
  596.        At any time you can type the <BACKSPACE> key to delete the left-most
  597.      character in the Locator.  As soon as you do, the table highlight bar will
  598.      move in reverse to highlight the filename that matches what is left of the
  599.      Locator.
  600.  
  601.        You can press ^<BACKSPACE> at anytime to clear all the characters from
  602.      the Locator.  When you do this, the highlight bar will not move.  It will
  603.      remain on the filename highlighted at the time you pressed ^<BACKSPACE>.
  604.  
  605.  
  606.     Freeware RXfer                                                            6
  607.      Copyright (c) 1992 Ronald J. Eisner
  608.      ___________________________________________________________________________
  609.  
  610.  
  611.      LOOKING UP FILE TRANSFERS BY BBS
  612.      --------------------------------
  613.  
  614.  
  615.        From the RXFER Main Menu select BBS ACTIVITY to examine the file transfer
  616.      database by specific BBS.  The BBS List table will appear.
  617.  
  618.        The BBS List is sorted in alphabetical order.
  619.  
  620.        From the BBS List, you can select the BBS for which you want to examine
  621.      file transfers.  The movement keys are the same as those for the File
  622.      Activity table (See THE FILE ACTIVITY TABLE, page 3), with two exceptions:
  623.      There is no Locator (because there will seldom be enough BBS entries to
  624.      warrant one); and pressing <ENTER> does not bring up a detail record.
  625.  
  626.        To examine all file transfers for a specific BBS, highlight the desired
  627.      BBS on the BBS List table and press <ENTER>.  A File Activity table showing
  628.      just the file transfers for the selected BBS will appear.
  629.  
  630.        The BBS List File Activity table works identically as the File Activity
  631.      table described above (See THE FILE ACTIVITY TABLE, page 3); except that
  632.      only files for the selected BBS are displayed.
  633.  
  634.  
  635.  
  636.      EXPORTING DATA
  637.      --------------
  638.  
  639.  
  640.        Freeware RXfer has an export data feature to allow you to extract the
  641.      information contained in its databases.  You can use this feature to create
  642.      a TRANSFER.LOG file that you want to provide to another copy of RXfer for
  643.      processing into its database (such as a home or work copy).
  644.  
  645.        If the RXfer (or RXfer Plus) file layout ever changes in a future
  646.      release, you may be requested to export the data from the old version prior
  647.      to beginning to use the new release.  This can serve as a method to convert
  648.      the old version data format into the new version's.
  649.  
  650.        Data is exported to an ASCII file named TRANSFER.LOG in the same subdi-
  651.      rectory as the RXfer program.  The export format is similar to the format
  652.      created by Robocomm when it writes to TRANSFER.LOG (the minor differences
  653.      are seen as identical by RXfer).
  654.  
  655.        Any existing TRANSFER.LOG is deleted by RXfer prior to beginning the
  656.      export of data.  However, it is not likely that will happen because RXfer
  657.      will have already processed and deleted any existing TRANSFER.LOG upon
  658.      startup.
  659.  
  660.        The TRANSFER.LOG file created by the export process can be used to
  661.      rebuild the RXfer database.  If you export the RXfer databases and then
  662.      delete the XFERFILE and XFERBBS database files and keys (see DISTRIBUTION
  663.      FILE LIST, page vii); the next time you run RXfer, it will recreate the
  664.  
  665.  
  666.     Freeware RXfer                                                            7
  667.      Copyright (c) 1992 Ronald J. Eisner
  668.      ___________________________________________________________________________
  669.  
  670.  
  671.      databases from the export TRANSFER.LOG file as if it were a normal
  672.      TRANSFER.LOG file created by Robocomm.  You likely would have no reason to
  673.      do this, but if you find the need the capability is there.
  674.  
  675.        To export the RXfer databases, choose EXPORT TO TRANSFER.LOG from the
  676.      Main Menu.
  677.  
  678.        A window will appear that explain that any existing TRANSFER.LOG will be
  679.      overwritten.  You are given an opportunity to change your mind by selected
  680.      NO or proceeding by selecting YES from a menu.  The default response is
  681.      always NO so pressing <ENTER> without paying attention will simply exit you
  682.      back to the Main Menu.
  683.  
  684.        Select YES to begin the export process.
  685.  
  686.        A window will appear which displays the total number of records in the
  687.      database (this is the number to be exported) and an incrementing count of
  688.      the current number of records exported thus far.
  689.  
  690.        The export process is fast.  (On a 20Mhz 386 running under DESQview with
  691.      one other multi-tasking process running, exporting 200 records takes just
  692.      seven seconds.)
  693.  
  694.        Once the export process is complete, RXfer will prompt you to press any
  695.      key to return to the Main Menu.  Once you do press any key, the Main Menu
  696.      will indeed reappear.
  697.  
  698.  
  699.  
  700.      QUITTING RXFER
  701.      --------------
  702.  
  703.  
  704.        To quit RXfer and exit back to DOS (or whatever program called RXfer for
  705.      you), simply select QUIT PROGRAM from the Main Menu and press <ENTER>.
  706.      There is no confirmation for the Quit selection, so if you accidentally
  707.      quit, you'll just need to restart RXfer.
  708.  
  709.  
  710.     Freeware RXfer                                                            8
  711.      Copyright (c) 1992 Ronald J. Eisner
  712.      ___________________________________________________________________________
  713.  
  714.  
  715.      TECHNICAL SUPPORT
  716.      -----------------
  717.  
  718.  
  719.        Even though Freeware RXfer is free, you can obtain technical support for
  720.      problems.  However, do not expect live operators, automated attendants, or
  721.      800-number service!
  722.  
  723.        Technical support is available these ways:
  724.  
  725.  
  726.        1 - Via the official support BBS:
  727.  
  728.              Planet X BBS
  729.              Sysop Tim Kilgore
  730.              Columbia MO
  731.              Node 1: 314-443-0319  USR HST/v.32 (public node)
  732.              Node 2: 314-442-0187  DIS v.32bis  (subscriber and new user node)
  733.              Node 3: 314-874-5887  (subscriber and new user node)
  734.              Wildcat! 3.02 BBS System (at this writing)
  735.              ASP Approved BBS
  736.  
  737.              After going through the New User requirements, you can <J>oin the
  738.              PCCS Support Conference and leave E-Mail to Ron Eisner (the au-
  739.              thor).  This was conference #6 at this writing - but that is
  740.              subject to change.  Check the conference list (by pressing <L>
  741.              AFTER selecting <J>oin from the main menu.  Ron checks in every
  742.              other day or so.
  743.  
  744.              You can also download free the latest version of Freeware RXfer
  745.              and Shareware RXfer Plus by accessing the PCCS Distribution &
  746.              Support file area (area 46 at this writing).  The filenames to
  747.              watch for are FRX???.ZIP (Freeware RXfer) and SRX???.ZIP
  748.              (Shareware RXfer Plus), where "???" represents the version
  749.              number.
  750.  
  751.              You may want to read the following Planet X bulletins after logging
  752.              on:
  753.  
  754.                          ┌─────────────────────────────────┐
  755.                          │   System & General Information  │
  756.                          │                                 │
  757.                          │  1. About Planet ><             │
  758.                          │  2. Subscriber Information      │
  759.                          │  3. Security Levels used        │
  760.                          │  5. Free Files listing          │
  761.                          └─────────────────────────────────┘
  762.  
  763.  
  764.        2 - Via Compuserve:
  765.  
  766.              Leave E-Mail to Ron Eisner at C.I.S. I.D. 74010,3011.  Ron checks
  767.              in to C.I.S. about once every other day.
  768.  
  769.     Freeware RXfer                                                            9
  770.      Copyright (c) 1992 Ronald J. Eisner
  771.      ___________________________________________________________________________
  772.  
  773.  
  774.  
  775.        3 - In writing:
  776.  
  777.              Please submit written requests for support, suggestions, and bug
  778.              reports to:
  779.  
  780.              PC CONSULTING SERVICES
  781.              PO BOX 30137
  782.              COLUMBIA  MO  65205-3137
  783.  
  784.              Please include your mailing address; and your telephone number in
  785.              case the author would like to reach you via voice.
  786.  
  787.  
  788.        The author also regularly monitors both the RIME and ILINK ROBOCOMM
  789.      conferences - but a response is NOT guaranteed.  However, it may be worth a
  790.      try.
  791.  
  792.  
  793.  
  794.      NEW VERSION AVAILABILITY
  795.      ------------------------
  796.  
  797.  
  798.        You can obtain free new releases of Freeware RXfer and Shareware RXfer
  799.      Plus from at least the two following BBS's:
  800.  
  801.        1 - Planet X BBS
  802.  
  803.              For access information, see TECHNICAL SUPPORT, page 8.
  804.  
  805.        2 - Group One BBS (Home of Robocomm)
  806.  
  807.              For access information, see your Robocomm BBS Directory or your
  808.              Robocomm documentation.
  809.  
  810.        The filenames to watch for are FRX???.ZIP (Freeware RXfer) and SRX???.ZIP
  811.      (Shareware RXfer Plus), where "???" represents the version number.
  812.  
  813.        Shareware RXfer Plus may also be ordered directly from PC Consulting
  814.      Services.
  815.  
  816.        Simply select PRINT ORDER FORM from the Main Menu (be sure your printer
  817.      is on line) to print a hardcopy order form with all the information
  818.      necessary for you to fill in.  Or, you can print out the file RXFER.FRM (an
  819.      ASCII file version of the order form).
  820.  
  821.        Send your order form, along with your check or money order, to PC
  822.      Consulting Services at the address on the order form (also listed above, on
  823.      page 9)
  824.     Freeware RXfer                                                           10
  825.      Copyright (c) 1992 Ronald J. Eisner
  826.      ___________________________________________________________________________
  827.  
  828.  
  829.      SHAREWARE RXFER PLUS
  830.      --------------------
  831.  
  832.  
  833.        Shareware RXfer Plus is an enhanced version of RXfer that offers more
  834.      features and control.  It is available from the same sources as Freeware
  835.      RXfer (see New Version Availability, page 9).  The price is $16; which gets
  836.      you a registered copy of the current version on disk.  (Registered copies
  837.      display your registration number on screen and do not have any Shareware
  838.      "Nag" screens.)
  839.  
  840.        Shareware RXfer Plus offers the following enhancements over Freeware
  841.      RXfer:
  842.  
  843.        *   Full statistics of your file transfer activities are maintained.
  844.            You can instantly see the total files and bytes uploaded and
  845.            downloaded from each BBS in the database.  Total time spent
  846.            transferring is also kept; along with your upload/download ratio,
  847.            among other stats.
  848.  
  849.        *   Command line operation allows you to look up file or BBS activity
  850.            from within Robocomm.  For example, you highlight a filename in
  851.            the Downloaded Files database, press [F5] (the Robocomm hot key
  852.            that calls RXfer Plus) and have RXfer Plus show you to what
  853.            systems you have transferred that specific file.  This makes
  854.            lookups very easy and convenient!  Usable sample batch files
  855.            included.
  856.  
  857.        *   Automatic aging of the database according to your preferences.
  858.  
  859.        *   Printed reports of upload candidates; BBS statistics; more.
  860.  
  861.        *   Batch processing of Robocomm's TRANSFER.LOG allows you add files
  862.            to the RXfer Plus database automatically after every agenda.
  863.            Usable sample batch files included.
  864.  
  865.        *   Multiple "spill" files!  Automatic aging of spill files.  Can be
  866.            auto-named TRANSFER.001 up to TRANSFER.099, with selectable
  867.            maximum size.  Unrecognized log entries can be spilled to a
  868.            different file (user nameable - default TRANSFER.U01).
  869.  
  870.        *   Program can be located in ANY subdirectory.  You tell it where to
  871.            look for TRANSFER.LOG and ROBOCOMM.
  872.  
  873.        *   User-nameable data export filename.
  874.  
  875.        *   Plenty of configuration and customization options.
  876.  
  877.        *   A registered copy of Robocomm is not required to run RXfer Plus.
  878.     Freeware RXfer
  879.      Copyright (c) 1992 Ronald J. Eisner
  880.      ___________________________________________________________________________
  881.  
  882.  
  883.      INDEX
  884.      -----
  885.  
  886.  
  887.      ^<BACKSPACE>  4, 5
  888.      ^<PGDN>  4
  889.      ^<PGUP>  4
  890.      <ARROW KEYS>  4
  891.      <BACKSPACE>  4, 5
  892.      <DELETE>  4
  893.      <END>  4
  894.      <ENTER>  4, 6, 7
  895.      <ESC>  4
  896.      <HOME>  4
  897.      <PGDN>  4
  898.      <PGUP>  4
  899.      ALPHANUMERIC KEYS  4
  900.      ANALYZE.FRX  vii
  901.      ARCHIVE FORMAT  v, 1
  902.      AUTHOR
  903.           (see also Eisner, Ron)  iii, iv, v, 1, 8, 9
  904.      AUTOMATIC TRANSFER.LOG PROCESSING  2
  905.      BBS  iv, v, vi, vii, 1-4, 6, 8-10
  906.      BBS ACTIVITY  6, 10
  907.      BBS LIST  6
  908.      CLEAR ENTIRE LOCATOR  4
  909.      COMPUSERVE
  910.           (Technical Support)  8
  911.      CONFIGURATION  vii, 1, 10
  912.      DELETE HIGHLIGHTED RECORD  4
  913.      DELETE ONE LOCATOR CHARACTER  4
  914.      DELETING CHARACTERS FROM THE LOCATOR  5
  915.      DESC.SDI  iv, vii
  916.      DESQVIEW  vi, 7
  917.      DISCLAIMER OF WARRANTY  iii
  918.      DISTRIBUTION FILE LIST
  919.           (see also FILES)  iv, vii, 1, 2, 6
  920.      DOS  vi, 1, 7
  921.      DR DOS  vi
  922.      DUPLICATE RECORDS  2
  923.      EISNER, RON
  924.           (author)  i, iv, 8
  925.      EXIT BACK TO DOS  1, 7
  926.      EXIT TABLE  4
  927.      EXPORT TO TRANSFER.LOG  7
  928.      EXPORTING DATA  6
  929.      FEATURES  vi, 10
  930.      FILE TRANSFERS  v, 3, 6
  931.      FILE_ID.DIZ  iv, vii
  932.      FILENAME LOCATOR  4
  933.      FILES
  934.           ANALYZE.FRX  vii
  935.           DESC.SDI  iv, vii
  936.     Freeware RXfer
  937.      Copyright (c) 1992 Ronald J. Eisner
  938.      ___________________________________________________________________________
  939.  
  940.  
  941.           DISTRIBUTION FILE LIST  iv, vii, 1, 2, 6
  942.           FILE_ID.DIZ  iv, vii
  943.           RXFER.CFG  vii, 1
  944.           RXFER.DOC  vii
  945.           RXFER.EXE  vii
  946.           RXFER.FRM  vii, 9
  947.           RXFER.HLP  vii
  948.           RXFER.NEW  vii
  949.           TRANSFER.001  vii, 2, 10
  950.           TRANSFER.LOG  v, vi, vii, 1-3, 6, 7, 10
  951.           XFERBBS  v, vii, 2, 3, 6
  952.           XFERFILE  v, vii, 2, 6
  953.      FILES CREATED BY FREEWARE RXFER  vii
  954.      FILES=20  vi
  955.      FINDING FILES WITH THE LOCATOR  5
  956.      FREE RAM  vi
  957.      FREEWARE  i, iii, iv, v, vi, vii, 1, 2, 6, 8-10
  958.      GROUP ONE BBS (HOME OF ROBOCOMM)  9
  959.      HIGHLIGHT BAR  v, 4, 5
  960.      INSTALLATION  vi, 1
  961.      KEYS  2, 4-6
  962.      LICENSE AGREEMENT  iv
  963.      LIMITS OF LIABILITY  iii
  964.      LOCATOR  v, vi, 4-6
  965.      LOG DETAIL  4
  966.      LOOKING UP FILE TRANSFERS  3, 6
  967.      LOOKING UP FILE TRANSFERS BY BBS  6
  968.      LOOKING UP FILE TRANSFERS BY FILENAME  3
  969.      NEW VERSION AVAILABILITY  9, 10
  970.           Group One BBS (Home of Robocomm)  9
  971.           PC CONSULTING SERVICES  9
  972.      OPTIONS  1, 2, 10
  973.      ORDER FORM  vii, 9
  974.      PC CONSULTING SERVICES
  975.           (Technical Support, Ordering)  9
  976.      PLANET X BBS
  977.           (Technical Support)  8, 9
  978.      PRINT ORDER FORM  9
  979.      PROGRAM
  980.           CONFIGURATION  1
  981.           FEATURES  vi
  982.           REQUIREMENTS  vi
  983.      PUNCTUATION  4, 5
  984.      QEMM  vi
  985.      QUIT PROGRAM  7
  986.      QUITTING RXFER  7
  987.      REGISTERED COPY OF ROBOCOMM  iv, vi, 10
  988.      REQUIREMENTS  vi, 8
  989.      ROBOCOMM  i, iv, v, vi, vii, 1, 2, 5-7, 9, 10
  990.      RXFER PLUS  vii, 1, 2, 6, 8-10
  991.      RXFER.CFG  vii, 1
  992.      RXFER.DOC  vii
  993.      RXFER.EXE  vii
  994.     Freeware RXfer
  995.      Copyright (c) 1992 Ronald J. Eisner
  996.      ___________________________________________________________________________
  997.  
  998.  
  999.      RXFER.FRM  vii, 9
  1000.      RXFER.HLP  vii
  1001.      RXFER.NEW  vii
  1002.      SCROLL DOWN ONE PAGE  4
  1003.      SCROLL UP ONE PAGE  4
  1004.      SHAREWARE  vii, 1, 8-10
  1005.      SHAREWARE RXFER PLUS  vii, 1, 8-10
  1006.           AVAILABILITY  10
  1007.           FEATURES  10
  1008.           ORDERING  9
  1009.      SUBDIRECTORY  vi, 1, 6, 10
  1010.      TABLE KEYS  4
  1011.      TABLE OF CONTENTS  ii
  1012.      TECHNICAL SUPPORT  8, 9
  1013.           Compuserve  8
  1014.           ILINK  9
  1015.           In writing  9
  1016.           PC CONSULTING SERVICES  9
  1017.           Planet X BBS  8, 9
  1018.           RIME  9
  1019.      THE FILE ACTIVITY TABLE  3, 4, 6
  1020.      THE LOCATOR  4, 5
  1021.      TRANSFER.001  vii, 2, 10
  1022.           prune  2
  1023.      TRANSFER.LOG  v, vi, vii, 1-3, 6, 7, 10
  1024.      USING THE LOCATOR  4
  1025.      WARRENTY
  1026.           DISCLAIMER OF WARRANTY  iii
  1027.      WHAT IS RXFER?  v
  1028.      XFERBBS  v, vii, 2, 3, 6
  1029.      XFERFILE  v, vii, 2, 6
  1030.  
  1031.